Qris Terminal Update

Generate Terminal

Service ini di gunakan untuk melakukan update nama terminalId baru

Service Info

HTTP Method	POST
Service Code	94
Http Method	POST
Path	.../v1.0/qr/qr-update-terminal
Authentication	OAuth 2.0

Header

Header Name	Tipe Data	Wajib	Deskripsi
Content-Type	String	Y	application/json
X-TIMESTAMP	String	Y	Waktu lokal klien saat ini yyyy-MM-ddTHH:mm:ss.SSSTZD format
X-PARTNER-ID	String	Y	Client’s client_id (diberikan pada saat onboarding )
X-CHANNEL-ID	String	Y	ID channel merchant
X-SIGNATURE	String	Y	Dibuat dengan algoritma asymmetric with token : Signature Generation
X-EXTERNAL-ID	String	Y	ID external merchant (tidak boleh sama di hari yang sama)

Body

Parameter	Tipe Data	Wajib	Deskripsi
merchantId	String	Y	ID unik yang dimiliki oleh setiap merchant Length: 0-16 Allowed Chars: 0-9
oldTerminalId	String	Y	ID terminal lama Length: 0-16 Allowed Chars: a-z A-Z 0-9  -
newTerminalId	String	Y	ID terminal baru Length: 0-16 Allowed Chars: a-z A-Z 0-9  -
description	String	Y	Deskripsi dari terminal

JSON

{
    "merchantId": "121xxxx",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description" : "update kasir lantai 01 to lantai 02"
}

CURL

curl --location --request POST '../qr/qr-update-terminal' \
--header 'x-timestamp: 2025-08-15T03:08:51.020Z' \
--header 'x-signature: bZZxvXG3aQyeGkVpPLhu1c4dzGmbIfmPye3F4nHUaInRacz21K83Mn/eW4Dge+LuA32jkJAhVegKpM/L1ysrzg==' \
--header 'x-partner-id: 53acd361-97ef-42ed-a359-782b21c5ffe1' \
--header 'channel-id: 0002' \
--header 'x-external-id: 671d96fb-f545-4091-802f-fsa382k29gks2' \
--header 'Authorization: Bearer 671d96fb-f545-4091-802f-f68a0f89055e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "121xxxx",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description" : "update kasir lantai 01 to lantai 02"
}'

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '../qr/qr-update-terminal',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "merchantId": "121xxxx",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description" : "update kasir lantai 01 to lantai 02
}',
  CURLOPT_HTTPHEADER => array(
    'x-timestamp: 2025-08-15T03:08:51.020Z',
    'x-signature: bZZxvXG3aQyeGkVpPLhu1c4dzGmbIfmPye3F4nHUaInRacz21K83Mn/eW4Dge+LuA32jkJAhVegKpM/L1ysrzg==',
    'x-partner-id: 53acd361-97ef-42ed-a359-782b21c5ffe1',
    'channel-id: 0002',
    'x-external-id: 671d96fb-f545-4091-802f-fsa382k29gks2',
    'Authorization: Bearer 671d96fb-f545-4091-802f-f68a0f89055e',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

NODE JS

var request = require('request');
var options = {
  'method': 'POST',
  'url': '../qr/qr-update-terminal',
  'headers': {
    'x-timestamp': '2025-08-15T03:08:51.020Z',
    'x-signature': 'bZZxvXG3aQyeGkVpPLhu1c4dzGmbIfmPye3F4nHUaInRacz21K83Mn/eW4Dge+LuA32jkJAhVegKpM/L1ysrzg==',
    'x-partner-id': '53acd361-97ef-42ed-a359-782b21c5ffe1',
    'channel-id': '0002',
    'x-external-id': '671d96fb-f545-4091-802f-fsa382k29gks2',
    'Authorization': 'Bearer 671d96fb-f545-4091-802f-f68a0f89055e',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "merchantId": "121xxxx",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description": "update kasir lantai 01 to lantai 02"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

GO

var request = require('request');
var options = {
  'method': 'POST',
  'url': '../qr/qr-update-terminal',
  'headers': {
    'x-timestamp': '2025-08-15T03:08:51.020Z',
    'x-signature': 'bZZxvXG3aQyeGkVpPLhu1c4dzGmbIfmPye3F4nHUaInRacz21K83Mn/eW4Dge+LuA32jkJAhVegKpM/L1ysrzg==',
    'x-partner-id': '53acd361-97ef-42ed-a359-782b21c5ffe1',
    'channel-id': '0002',
    'x-external-id': '671d96fb-f545-4091-802f-fsa382k29gks2',
    'Authorization': 'Bearer 671d96fb-f545-4091-802f-f68a0f89055e',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "merchantId": "121xxxx",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description": "update kasir lantai 01 to lantai 02"
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Response

Parameter	Tipe Data	Deskripsi
responseCode	String	Kode response
responseMessage	String	Pesan response
oldTerminalId	String	Id terminal lama
newTerminalId	String	Id terminal baru
description	String	Deskripsi terminal

{
    "responseCode": "2009400",
    "responseMessage": "Successful",
    "oldTerminalId": "KASIRLT01",
    "newTerminalId": "KASIRLT02",
    "description": "update kasir lantai 01 to lantai 02"
}

List Response Code

Response Code	Response Message	Description
2009200	Success
4009201	Invalid field format { field name }
4019200	Unauthorized. Invalid Signature	X-Signature salah
4099200	Cannot use same X-EXTERNAL-ID in same day	X-External-ID sudah pernah digunakan di hari yang sama
4049201	Bad Request	Request header ada yang salah / kurang
4049200	Unauthorized. Client Forbidden Access API	Partner tidak dapat mengakses api terkait
4039219	Merchant Blacklisted	Merchant telah di blacklist
4049208	Invalid Merchant	MerchantId tidak valid
5009201	Internal Server Error	Terjadi kesalahan di sistem internal